*****************************************************************
*
* PAW Utility Disk #1 Ver 2.60  -  October 29, 2000. Copyright by Peter Watson.
* ----------------------------
*
******************************************************************
*
* Notice:  This disk is SHAREWARE. That means you may copy it and
* ======   you are encouraged to give copies to your friends. You
*          may use any or all of the utilities on this disk for a
*          period of two weeks. At the end of that time you are
*          required to send the SHAREWARE fee to the address below,
*          or to erase any copies of the disk that you may have.
*          When I receive your SHAREWARE fee I will send you the
*          latest version of the disk, including the source code
*          files if required, and register you as a legitimate user.
*          This will entitle you to support, notification of major
*          updates and any suggestions you may have are much more
*          likely to be acted on. Registered users are entitled to
*          the first upgrade for free, and further updates for $5.
*          If you wish to upgrade to the 'Source Code Included'
*          version at any time, the cost is simply the difference
*          between the 'No Source' and 'Source Code Included' fees.
*
*====================================================================
*
*       The SHAREWARE fee for this disk including the source files is:
*
*                             $25.00.
*
*       The SHAREWARE fee if the source files ARE NOT required is:
*
*                             $10.00.
*
*====================================================================
*
*       The author of this software makes no warranty or representation
*       either express or implied regarding the merchantability or fitness
*       of any of the contents of this disk for any particular purpose.
*       This software is provided "as is" and the user is assuming the
*       entire risk as to its quality and performance.
*
*       The author of this software will not be liable for direct,
*       indirect, special, incidental or consequential damages resulting
*       from any defect in the software or its documentation.
*
*       ProDOS, GS/OS and Apple are registered trademarks of Apple Computer,
*       Inc. Applesoft and Apple IIgs are trademarks of Apple Computer, Inc.
*       ORCA/M and ORCA/C are trademarks of The Byte Works, Inc. GNO/ME is
*       a trademark of Procyon Enterprises Inc.
*
*====================================================================
*
*       All files (other than ICON files) on this disk are:
*
*               Copyright 1988-2000 by Peter Watson.
*
*       You may not sell these programs, nor charge more than a
*       reasonable copying fee for copying the disk. You may use the
*       accompanying source code (if present) as a basis for your
*       own programs, but if such programs are to be used by anyone
*       other than you and your immediate family, then you must
*       include the following notice:
*
*       Parts of this program are Copyright 1988-2000 by Peter Watson.
*
*====================================================================
*
*       Some programs are written in ORCA/C. They will briefly acknowledge
*       Byte Works in their copyright. This is the formal acknowledgement:
*
*       This program contain material from the ORCA/C
*       Run-Time Libraries, copyright 1987-1993
*       by Byte Works, Inc. Used with permission.
*
******************************************************************
*
*       SHAREWARE disks have been few and far between in Australia,
*       because Australians have a very poor reputation of actually
*       paying the SHAREWARE fee. Help to keep the SHARWARE concept
*       alive and well in Australia by supporting this disk.
*
*               Peter Watson
*               P.O. Box 493
*               Doncaster  Vic  3108
*               Australia
*
*               paw@acslink.net.au
*
******************************************************************

WHAT IS THIS DISK?
==================
This disk contains a collection of utilities that have been written mostly
for use under the APW or ORCA/M command shells, although most will also
execute under the GNO/ME and ProSel command shells as well. Also, many of them
will execute correctly directly from the Finder or any other ProDOS (or GS/OS)
program launcher, if the filetype is changed from EXE to S16 using the included
'FILETYPE' utility. There are also a number of utilities written for Applesoft
(on //e, //c and IIgs) and GSBasic BASIC, and several classic desk accessories.

Currently three utilities require GS/OS - 'ONLINE', 'SHUTDOWN' and 'SPACE'.
                          =======
Also, the NULL device driver is only usable under GS/OS.
Utilities accessing resource data will require GS/OS for that function only.
(eg. DUMP, or TOGGLE (for the ShutDown option))

The majority of the programs in the UTILS directory may be 'paused' by
pressing (almost) any key, and 'cancelled' by pressing <Open-Apple><.>,
(Open-Apple-Period). If processing multiple files with wildcards in 'DUMP'
and 'PLAY', then this will simply advance to the next file. Press <Option><.>
to cancel out of the program entirely.

The program disk contains the following directories:

ASOFT           Utilities written in (or used under) Applesoft BASIC.

DA              Desk Accessories (CDAs and/or NDAs). You must copy them to the
                SYSTEM/DESK.ACCS directory on your 'system disk' and restart
                the computer.

DRIVERS         Device driver(s). You must copy them to the SYSTEM/DRIVERS
                directory on your 'system disk' and restart the computer for
                them to be available.

EXECS           Useful or required APW EXEC files.

GSBASIC         Utilities written in GSBasic. In general, they should be
                usable with the TML BASIC compiler with minor modifications.
                The files are also included as text files for TML BASIC users,
                but the line numbers will have to be removed first.

HELP            Help files for many of the programs, the remainder being
                documented below. Note that help files have been added for the
                built-in commands 'COMPRESS' and 'SWITCH', which were omitted
                from APW due to an error by Apple. All that needs to be done to
                activate these commands is to add the appropriate entries to
                the SYSTEM/SYSCMND command table (see the SYSCMND.SAMPLE file).
                The help files are specifically written for the APW / ORCA shell
                environment, but they generally apply to running from the Finder
                although wildcards are not available, and if the program does
                not prompt you, then you may not be able to enter options.

ICONS           Icon files - both for my programs, and for others that I am
                providing just so people will have icons if they get data files.
                PAW.ICONS should contain all the icons I have created (using
                David Lyon's shareware utility 'DIcEd'), but to override some
                of the Finder defaults, I had to merge them with FINDER.ICONS.

SOURCE          Source code and macros for the programs in the UTILS directory.
                The files have been compressed into a self-extracting archive
                using ShrinkIt GS. Simply run the program to extract the files
                to a separate disk, normally named /PAW.1.Source.
                The files are in ORCA/M or APW format. (ORCA/M includes a
                file detailing macro differences between APW and ORCA/M).

                Note that these files are only present on the disk sent to
                REGISTERED users who have paid the source code fee.

UTILS           The majority of the actual utility programs. Some of the
                utilities still prompt for missing parameters by using the
                text tool '_ReadLine' toolbox call. This is a simple call,
                with one major flaw - it does not support Delete or backspace!
                If you realise you have made a mistake, press the Delete key
                anyway, then press the Return key. This will cause a parameter
                'syntax error', and you will be prompted again. The more
                recent programs use my READLN subroutine to provide support
                for backspace, Delete and Escape. Note that with most
                programs, if you are prompted for a parameter and you simply
                press Return, the program will exit.

SYSCMND.SAMPLE  This is a sample SYSCMND file for ORCA/APW, which would normally
                be merged with the existing SYSTEM/SYSCMND file. Most of the
                files have been marked as restartable (ie. '*U' instead of 'U').

SAMPLE.SOUND    A sample digitized sound file for use by PLAY.

The source disk (after extracting from the compressed archive file) contains
the following directories:

ASM             Source code and macros for the programs in the UTILS directory.
                The files are in ORCA/M or APW format. (ORCA/M includes a
                file detailing macro differences between APW and ORCA/M).

CC              Source code in APW C or ORCA/C format for utilities written in
                'C'. There is also a library file containing the compiled
                versions of the 'include' files contained in the ASM directory.

Note that these files are only present on the disk sent to REGISTERED users who
have paid the source code fee.

Details of utilities with no separate help file.
------------------------------------------------

ASCII.CDA       A CDA to display the ASCII character set (including MouseText
                characters). This CDA works under ProDOS 8, ProDOS 16 and GS/OS.

BASIC           This APW (or ORCA/M) EXEC file is required to use the BASICX
                program. See the help file for BASIC.

BASICX          An APW (or ORCA/M) utility used in conjunction with the BASIC
                EXEC file mentioned above. See the help file for BASIC.

BAS.TO.GSB      This GSBASIC utility will read an Applesoft BASIC program and
                perform some initial conversion of statements into GSBASIC (or
                TML BASIC) format, where possible. The output file may be
                specified as .CONSOLE to simply list the conversion. Note that
                the program creates a text file which must be EXEC'ed into
                memory and then saved (or compiled under TML BASIC).

BOOTMAKER       This ProDOS 8 BINary utility will write boot blocks (that is,
                blocks 0 and 1) onto any device that has already been formatted
                This can be useful in several cases. For example, most RAM
                disks will automatically be usable without the user explicitly
                formatting them. If you wish to boot from the RAM disk at some
                later time after copying files to the disk, then this utility
                will save the necessity of formatting the disk and recopying
                the files. Another example is that GS/OS has changed the boot
                blocks. The public domain utility (BLK0CHECK), used to check
                for a virus damaging block 0, assumes that a GS/OS formatted
                disk has been corrupted, and will not allow you to reboot. Or
                it may be simply that the boot blocks on a disk have been
                corrupted by a runaway program. Note that BOOTMAKER assumes
                the disk to be repaired is the first drive in a slot (the only
                drive you can boot from!). A future version of this program
                will support GS/OS boot blocks (which at present do not appear
                to be any different in function to the current blocks).

BOOTMAKER.GSOS  The updated version of BOOTMAKER which writes the GS/OS boot-
                blocks. Note that they 'should' still work with ProDOS 8 on
                a //e or //c, but I haven't tested that. You can now update
                drive/unit 2 by holding down the Open-Apple key while selecting
                the slot.

COLOR640        A simple Quickdraw II application to display the 16 default
                colours available with 640-mode dithered colours. The colours
                are numbered 0 to 15, from top-left to bottom-right.

COMPARE         This GSBASIC utility will compare two text files line-by-line.
                Lines that do not match will be displayed with the differences
                highlighted. When a difference is found, several options are
                available. These include the ability to skip a record on
                either of the input files, or to attempt to find two matching
                records by reading forward. This utility is very useful to
                work out the differences between two version of source code,
                or between an old and a new parameter file.

DIV.INC         Fast integer division routine. Enter in full native mode to
                divide Y by X. Answer in Acc, remainder in Y, carry set if X=0.

FILETYPE        This Applesoft BASIC utility allows you to easily change the
                filetype of a ProDOS file. You may enter the new filetype in
                decimal, hexadecimal (precede the value with '$') or by entering
                the ASCII mnemonic (eg. BAS, TXT, S16, EXE, etc). Note that
                the program will only work with Smartport type drives (ie. 3.5"
                disks, RAMcards or SCSI hard disks). The file FILETYPE.BIN is
                required to issue the necessary disk commands.

FIXCDA          A tiny program which restores the CDA menu if it has been
                disabled by a 'protected' program, such as 'Tass Times in Tone
                Town'. The annoying thing is not that it is disabled while
                the program is running, but that it is not restored when the
                program quits. Now all you have to do is run FIXCDA.

HOLD.CDA        A CDA to blank the screen and display a moving Apple to prevent
                screen burnout. Exit by any keyboard or mouse activity. Note
                that it is not based on lack of activity - you must explicitly
                activate the program. (I HATE my screen blanking by itself!)
                This CDA works under ProDOS 8, ProDOS 16 and GS/OS.

GOTOXY.INC      An assembler routine to move the cursor to a given screen
                location given in the X and Y registers. Used (will be used)
                by several programs in the future. Note that it works best if
                the cursor is turned off (by printing a $06 character). See
                'GOTOXY' in PAW.LIB.

LLIST           This is an Applesoft program saved in text format to be used by
                issuing an 'EXEC LLIST' command with a program to be printed in
                memory. It will append itself as line 0 to the front of the
                program. If RUN, it will prompt for a title, then list the file
                to an ImageWriter printer attached to slot 1. Long lines will
                be wrapped correctly, and page breaks will be skipped.

LPRINT          This APW (or ORCA/M) EXEC file will send a file to the printer
                with any remaining parameters (after the file name) being
                printed along with filename itself at the head of the print.
                eg. 'LPRINT Play.1 31 February 2001' would begin as follows:
                'File Play.1 - 31 February 2001', followed by a blank line.
                At the end, a prompt allows issuing of one or more formfeeds to
                the printer. Nb: A (printer?) problem means you should wait
                until printing finishes as formfeeds cause data to be lost.

LODEVIRUSFIND   This Applesoft BASIC program will check a disk for the presence
                of the 'Lode Runner' virus. Note that this virus infects the
                boot blocks of a disk, and then installs itself in memory in
                such a way that it survives a 'cold start' (ie. <Open-Apple>
                <Control><Reset>)! To defeat this virus, you must rewrite
                the boot-blocks using a utility such as BOOTMAKER, or by
                copying the files to another disk then initializing the
                'infected' disk. You *MUST* then TURN OFF THE COMPUTER to
                guarantee the virus is removed from memory, *BEFORE* booting
                any other disk using <Open-Apple><Control><Reset>.

MASS.FORMAT     This Applesoft BASIC utility allows you to easily format an
                entire box (or more) of 3.5" disks. If you have two drives,
                it automatically swaps drives without prompting. You can
                enter any interleave value, eg. 2:1 for GS/OS or 4:1 for ProDOS
                8. The default is 2:1. The file FORMAT.DATA is needed to write
                boot blocks and an empty directory onto the disk (all the disks
                will be named /BLANKx, where 'x' is the interleave value). Note
                that this program also demonstrates a method to find data files
                in the called program's directory, and how to eject 3.5" disks.

MULT8.INC       Fast 8-bit integer multiplication routine. Enter in full
                native mode to multiply Acc by X. Answer in Acc, X destroyed.
                Overflow is *NOT* detected!

NULL            A 'dummy' device driver which is useful to create an 'extra'
                device to test programs with, or to use as a 'bit bucket' for
                for suppressing command output under APW. It looks like a 64K
                ROM disk named /NULL containing one file named NULL. You can
                write or format the disk forever - nothing will happen. If you
                read from it, blocks 2 (the directory) and 6 (the bit map) will
                return valid information. All other blocks will return 512
                bytes of zeroes. This includes the file /NULL/NULL. An example
                of suppressing output would be:  ASML myprog >/NULL/NULL

PQUIT           A short Applesoft BASIC program which demonstrates how to
                execute a ProDOS 16 (GS/OS) program from BASIC, presuming that
                ProDOS 16 or GS/OS had been booted originally.

PAW.LIB         A library file containing pre-assembled routines used by several
                programs on this disk, and perhaps useful within your own. Note
                that the routines have UPPER-CASE names! (Important in 'C'.)
                Currently contains: STOP_PAUSE, READLN, SHOWACC, GOTOXY, MULT8,
                DIV.

PFSEXT          A shell utility to extract the data records from the original
                Pascal-based version of the PFS database program. The utility
                requires two parameters: the device number of the 5.25" drive
                containing the PFS data disk, and the path name for the output
                file. Enter PFSEXT without parameters for two other parameters.
                Based on a 1986 Applesoft program written by Jim Luther.

PICDUMP.CDA     A CDA to dump the Super Hi-Res screen (320 or 640 mode) to disk
                as a 65 block $C1 (PIC) file, which can then be loaded into all
                paint packages. The saved file will be called SCREEN.00. If
                SCREEN.0 exists, then SCREEN.01 will be created, and so on up to
                SCREEN.99. No messages are displayed - errors will simply cause
                a beep. This CDA works under ProDOS 8, ProDOS 16 and GS/OS.

PRINT.TEXT      A BASIC program to print one or all text files in a directory to
                the screen or printer. Useful to print copies of the various
                documentation files on this disk. It supports TXT and SRC files.
                This program has some interesting subroutines for scrolling
                menu selection, and dynamically vetting BASIC input. It was
                originally written to display the documentation and help files
                on this disk.

QUIT.TO.GSOS    A short routine which restores the "normal" GS/OS or ProDOS 16
                'QUIT' code which returns to GS/OS. This is intended to be used
                 when running ProDOS 8 under GS/OS, and the QUIT routine gets
                replaced or damaged by another program selector (eg. Squirt,
                Bird's Better Bye or the WINDOWS program from 'A2 Central').
                Simply execute the program, then QUIT to ProDOS in the normal
                way, such as issuing the 'BYE' command from BASIC.

READLN.INC      An assembler program segment to read a line from the standard
                input, including basic editing support and the <Esc> key. Used
                by several programs (more to come) to replace Apple's primitive
                '_ReadLine' toolbox call. See 'READLN' in PAW.LIB.

SHOWACC.INC     An assembler program segment to display the contents of the
                Accumulator on the screen, eg. '$0001' or '$1234'. I normally
                only use this routine for debugging, for which it is friendly
                and convenient (especially since it saves ALL registers and
                memory width, etc). It *does* assume native mode and that a
                'writestr' will write to the screen! Called by 'JSL ShowAcc'.
                See 'ShowAcc' in PAW.LIB.

SHOW.TIME       A short Applesoft BASIC program which demonstrates how to
                access the IIgs clock to display the time and date on the screen
                with minimal effort, accurate to the second.

STOP.PAUSE.INC  An assembler program segment to check the keyboard for the
                Open-Apple (or Option) and Period combination by the user
                requesting the termination of the current task. Based on an
                example in the APW Assembler Reference manual. Used by several
                programs on this disk. See 'STOP_PAUSE' in PAW.LIB.
                (Updated to STOP_PAUSE2 - displays hourglass while pausing)

SMARTPORT       This Applesoft BASIC utility displays details about any device
                attached to a //e, //c or IIgs using the Smartport interface.
                This includes UniDisk 3.5 interface cards, most SCSI interface
                cards, the Apple II Memory Expansion card and the IIgs slot 5
                Smart Port. You can also reset the Smartport using this
                program. Press '?' at any prompt for help. This program uses
                an interesting way of documenting the combination of machine
                code in an Applesoft program.

UNNEW           This binary file is designed to run under Applesoft BASIC with
                either ProDOS or DOS 3.3. It is designed to recover a program
                that is lost due to an accidental NEW (or FP under DOS 3.3)
                command. It can occasionally succeed in recovering from other
                errors which make the program in memory mysteriously disappear.
                Any time that LIST fails to display a program, simply enter
                BRUN UNNEW, then immediately save the program under a new name.
                Reload the program from disk (important!), and test it out
                before overwriting any previous versions.

*=================================================================
* Release Notes
*=================================================================
V1.00 - 4th February 1989
        Initial release

V1.01 - PAW.ICONS file fixed, and FINDER.ICONS deleted as unnecessary.
      - Delete BOOTVOL.
      - Add sample sound file (Help! by the Beatles).

*=================================================================
V1.10 - 20th February 1989
        Add BEEP command.
        Add READLN.INC and STOP.PAUSE.INC to source code.
        Add FILETYPE and LLIST Basic programs.
        Update DUMP to v2.1.

*=================================================================
V1.20 - 12th March 1989
        Add UNNEW Basic program.
        Update MASS.FORMAT to v3.02.
        Update DUMP to v2.2. (Note: Check help file for changed syntax.)
        Update PLAY to v1.4. (Add continuous and repeat play options)

*=================================================================
V1.30 - 1st April 1989
        Add SPACE utility v1.0. (Calculate space used within a directory)
        Update DUMP to v2.3. (AppleWorks WP file display format support)
        Update SHUTDOWN to v1.1. (End any GS/OS 'deferred-write' sessions first)
        Update PLAY to v1.41. (Use READLN subroutine to improve prompting)

V1.32 - 6th April 1989
        Add MORE utility v1.0. (Filter to pause after each 22 lines of output)
        Update ONLINE to v1.1. (Fix handling of errors and non-ProDOS volumes)

*=================================================================
V2.00 - 19th January 1990  (A big one! Sorry about the delay!)
        Add PURGE utility (Remove purgeable blocks from memory - free up space!)
        Add text file versions of GS Basic programs for TML Basic users.
        Add ASCII Table CDA v1.0. (First in DA directory!)
        Add HOLD CDA v1.1. (Screen protector)
        Add PRINT.TEXT v1.0 (Text file printer. Print text files on the disk.)
        Add STACKMIN.INC to source code and PAW.LIB (16K stack for 'C')
        Add QUIT.TO.GSOS (Restore GS/OS quit code if damaged/replaced)
        Add LODEVIRUSFIND (Detects 'Lode Runner' virus)
        Add FIXSOUND v1.2 (Converts Mac digitized sound files to GS format)
        Add BOOTMAKER.GSOS (From BOOTMAKER - GS/OS boot blocks; support drive 2)
        Update STOP.PAUSE.INC routine. (Option 'anything' would 'halt'!)
        Update SHUTDOWN to v1.2. (Check for GS/OS; add '-C'; use GS/OS macros)
        Update ERASE to v1.1. (Don't confirm under GS/OS; use READLN)
        Update MORE to v1.1. (Count lines that wrap around correctly)
        Update AUXTYPE to v1.4. (Add '-L' option; honour locked files; READLN)
        Update PLAY to v1.5. (Double click sounds from Finder; Change play rate
                              while in prompt mode; Play multiple files)
        Update DUMP to v3.0. (Applesoft BASIC file display format support;
                              prompted for options from Finder; minor bug fixes;
                              support for Shells other than APW or ORCA;
                              A/works 3.0 support; add '-O' offset option)
        Update MASS.FORMAT to v3.2. (Automatically recognise disk is in drive
                              and include interleave value in disk name)
        Update BOOTMAKER to v1.1. (Support 5.25" drives; better error handling)
        Update SMARTPORT to v1.51. (Fix multiple device bug; fix $2D error msg)
        Update SPACE to v1.2. (Misc bug fixes; run from Finder; 16K stack;
                               rewritten in ORCA/C; 'extended file' support)

V2.01 - 8th February 1990
        Add STRIPLF utility v1.0. (Remove <LineFeed> chars from a file)
        Update LPRINT exec file to allow repeated formfeeds.
        Update SPACE to v1.3. (Fix file count bug with wildcards; add '-L')
        Update FIXSOUND to v1.3. (Support Mac sound resources; ignore invisible
                                  files; fix header deletion bug)

*=================================================================
V2.10 - 7th March 1990
        Add SHOW.TIME and PQUIT Basic programs.
        Add GOTOXY.INC to source code and PAW.LIB code library.
        Add SORT filter. (Sort input and write it to output)
        Add STRIPCR filter. (Replaces <CR> chars with spaces to merge lines)
        Update LPRINT exec file to fix repeated formfeed code.
        Update DUMP to v3.1. (Add '-Q' for no msgs; '-R' for resource forks;
                              expand <Tab> chars; support '-O' for BASIC files)
        Update PURGE to v1.1. (Add '-L' for list only'; pathname displayed for
                               more blocks; skips Loader blocks (level=3).)
        Update SPACE to v1.4. (Add '-B' option for 'backup bit' space only;
                               v1.3 accidently disabled the '-O' option)

V2.11 - 14th March 1990
        Add FIXCDA utility. (Restores CDA menu vector if removed by program)

*=================================================================
V2.20 - 15th May 1990
        Actually put PURGE onto disk - copy routine had been omitting it!!
        Add SHOWACC.INC to source code and PAW.LIB library (standalone version
                        of example in DUMP).
        Add Color640 v1.0. (Displays default 640-mode dithered colour table).
                           (The first graphic application!)
        Add PICDUMP CDA. (Dumps Super Hi-Res screen to disk in ProDOS 8 & GS/OS)
        Add TOGGLE v1.0. (Toggles IIgs slot between card and internal port)
        Update MORE to v1.2. (Don't double count lines ending in a <CR>)
        Update SORT to v1.1. (Add '-C' for start column)
        Update SHUTDOWN to v1.3. (Apple/my bug fixes; SoftSwitch compatibility)
        Update DUMP to v3.11. (Fix for last line without a <CR> being omitted)
        Update HOLD to v1.2. (Fix occasional immediate exit; display title)

*=================================================================
V2.30 - 7th September 1991
        Add NULL v1.0. (Dummy device driver - allows redirection to 'thin air')
        Add MERGE v1.0. (Overlay one file on another, at a specified offset)
        Add LF.TO.CR v1.0. (Convert all <LF> characters to <CR> in a file)
        Add GETIL v1.0. (Get interleave and no. of sides for a 3.5" disk)
        Update MASS.FORMAT to v3.3. (Eject both drives initially; set default
                                     interleave to '2')
        Update PICDUMP to v1.01. (Disable interrupts if running under ProDOS 8)
        Update HOLD to v1.3. (Add a little bit of colour)
        Update STRIPLF to v1.01. (Fixed a potential bug in convert subroutine).
        Update PURGE to v1.21 (Add '-A' to display all blocks; show all owners)
        Update DUMP to v3.12. (Handle -A/B correctly if mixed types. Suppress
                               cursor suppress chars with output redirection.)
        Remove STACKMIN.INC from source code and PAW.LIB (redundant now)

*=================================================================
V2.40 - 2nd July 1992
        Add ADB.Reader v1.31. (Browse an AppleWorks ADB (database) file)
        Add SPEED v1.1. (Set/display the speed of a TransWarp GS from the Shell)
        Add DRead v1.0. (Read and display one or more disk blocks)
        Add DIV.inc. (Fast integer division subroutine)
        Add MULT8.inc. (Fast 8-bit integer multiplication subroutine)
        Delete SLOTS. (Function included in ONLINE 2.1)
        Delete CLS. (Function added (as HOME command) in ORCA/M 2.0)
        Update PURGE to v1.22 (Ooooops! - v1.21 stopped it actually purging!)
        Update ONLINE to v2.2 (Include SLOTS function; display HFS vol names)
                              (Display MS-DOS vol names)
        Update SHOWICON to v1.1 (Handle wildcards in pathnames)
        Update ERASE to v1.2 (GS/OS only. Handle 31-char dev & path names)
        Update MORE to v1.3 (Handle ORCA 2 shell. Fix inconsistent line count)
        Update STOP.PAUSE.INC to v1.1. (Display 'hourglass' while waiting)
                                       (*NOT* added to PAW.LIB)
        Change PLAY auxtype to $DB04. (Message Center Aware flag)

*=================================================================
V2.50 - 30th July 1994
        Add HFSFileType v1.0. (View and modify HFS type and creator fields)
        Add MRead v1.11. (Display memory in hex and ASCII, or save to a file)
        Add MakeData v1.0. (Convert binary file data to hex characters)
        Update DUMP to v3.2. (Ignore invisible files in -T mode. Fix 8-bit tool
                              call bug. Handle quoted filenames and ProSel)
        Update DUMP to v4.0.2. ('?' while paused shows file & offset. <LF> acts
               like <CR> if not after <CR>. '-I' alters <tab> default width.
               '-TT' option makes some TeachText data printable, eg. '(TM)'.
               '-M' option displays Merlin source format. '-1' reads 1 block at
               a time (for files with bad blocks). Tag data at end of AWP files
               is displayed. AWP lines now end in <CR>. Short text/AWP lines no
               longer blank padded. '-X' no longer repeats last line if 'OA-.'
               pressed. Tab stops now start at 1, not 0. Control chars in BASIC
               data now suppressed (except <CR> and <LF>). Whew!! A big one!!
        Update ASCII to v1.02. (Handle console driver and event manager better)
        Update HOLD to v1.4. (Handle console driver in ORCA 2.0 and System 6.0)
        Update SMARTPORT to v1.53. (Support newer devices; extra info; bug fix)
        Update ONLINE to v2.21. (Wait for keypress if called from the Finder)
        Update DRead to v1.21. (Bugfix. Add '-A' to display ASCII only.
                               Add '-F pathname' to save blocks to a file)
                               Add '-FA pathname' to append blocks to a file)
        Update AUXTYPE to v1.51. ([A]nd, [O]r, [X]or prefixes on new AUXtype)
        Update PAW.LIB to include v1.1 of STOP.PAUSE.INC (as STOP_PAUSE2).
        Update MASS.FORMAT to v3.4. (Write correct directory for 1.44Mb disks)
        Update ADB.Reader to 1.41. (Works from Finder! Add <OA-J>ump command)
        Update LF2CR (formerly LF.to.CR) to v1.01. Slightly faster and smaller.

*=================================================================
V2.60 - 29th October 2000
        Add DWrite v1.2 (Write one or more disk blocks)
        Add PFSExt v1.0 (Extract all data from a non-ProDOS PFS data disk)
        Update DUMP to v4.3. (Handle AWP V5.0 inverse/mousetext; display AWP
                              bold/underline in inverse; minor AWP/BAS bugs;
                              now requires ORCA shell v2.0 for wildcards;
                              ensure 16-bit mode for tool calls in STOP_PAUSE;
                              handle I/O errors better; Merlin tabs generate
                              at least 1 space; show EOF in file offset line)
        Update SHUTDOWN to v1.4. (Add '-R' restart option; fix help file)
        Update ONLINE to v2.32. (Handle MSDOS disks created by Windows 95;
                              display format fixes; handle ISO 9660 FST & MSDOS
                              hard-disk partitions; show device no. in decimal;
                              add '-M' option to mount offline SCSI disks)
        Update Space to v1.42. (Better support for non-ORCA shells, esp. ProSel)
        Update DRead to v1.5. (Add '-S string' to search; the endBlock value can
                              be a 'count'; fix check for <command-.> when
                              writing to a file; add '-Z' to shorten display
                              for blocks with all zero data; hex search bug fix)
        Update ADB.Reader to 1.42. (Fixed intermittent pointer bug;
                              add '=' or <oa-G> for Repeat Find)
        Update PLAY to v1.51. (Quietly ignore directories included by wildcards)

******************************************************************
*
*       SHAREWARE disks have been few and far between in Australia,
*       because Australians have a very poor reputation of actually
*       paying the SHAREWARE fee. Help to keep the SHARWARE concept
*       alive and well in Australia by supporting this disk.
*
*       The SHAREWARE fee for this disk including the source files is $25.00.
*
*       The SHAREWARE fee if the source files are not required is $10.00.
*
*               Peter Watson
*               P.O. Box 493
*               Doncaster  Vic  3108
*               Australia
*
*               paw@acslink.net.au
*
******************************************************************
* End of file
******************************************************************
